=============================================================================
Poll Widget [NAT]
Version: 1.0.0
Compatibility: OpenCart 2.0.x - 2.2.x / ocStore 2.1.x - 2.2.x
Author: NAT
Contact: info@nat.od.ua
=============================================================================

--- [ РУССКИЙ ] -------------------------------------------------------------

ОПИСАНИЕ:
Poll Widget [NAT] — это функциональный модуль для создания опросов и голосований на вашем сайте.
1. Позволяет создавать опросы с мультиязычными вопросами и вариантами ответов.
2. Гибкие правила голосования: разрешение/запрет голосования для гостей, настройка лимита голосов на одного пользователя или IP-адрес.
3. Настраиваемый формат результатов: вывод в процентах, в количестве голосов, всё вместе или скрытие результатов (только текст благодарности).
4. Встроенный дизайн: полное управление цветами виджета (фон, текст, кнопки, полосы прогресса) прямо из админки с помощью удобного ColorPicker.
5. Продвинутая статистика: просмотр реальных голосов, возможность ручной корректировки результатов (управление статистикой) и подробный журнал голосов с фиксацией IP, имени пользователя и страницы, с которой был отдан голос.

УСТАНОВКА:
1. Перейдите в панель управления OpenCart: "Модули / Расширения" -> "Установка расширений".
2. Загрузите архив poll_widget_nat_OC_20_22_1_0.ocmod.zip.
3. Перейдите в "Модули / Расширения" -> "Модификаторы" и нажмите синюю кнопку "Обновить" (Очистить кэш).
4. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите вашу группу (Administrator), нажмите "Выделить все" в правах просмотра и изменения, затем сохраните.
5. Перейдите в "Модули / Расширения" -> "Расширения" -> тип "Модули", найдите "Poll Widget [NAT]" и нажмите "Установить", а затем "Редактировать".

ОБНОВЛЕНИЕ:
1. Загрузите новый архив через "Установка расширений" поверх старого.
2. Обновите кэш в разделе "Модификаторы".
3. Очистите кэш браузера (Ctrl+F5) на странице настроек модуля.

УДАЛЕНИЕ:
1. Перейдите в "Модули / Расширения", найдите модуль и нажмите красную кнопку "Деинсталлировать".
2. Перейдите в "Установка расширений", найдите модуль в истории загрузок и удалите его файлы.
3. Обновите кэш модификаторов.

ИНСТРУКЦИЯ ПО ИСПОЛЬЗОВАНИЮ:
- Создание опроса: Добавьте новый опрос, заполните вопросы и ответы для нужных языков, настройте права для гостей и лимиты.
- Внешний вид: Перейдите во вкладку "Дизайн и цвета", чтобы настроить палитру виджета под стиль вашего магазина.
- Статистика: Во вкладке "Статистика и накрутка" вы можете видеть реальные данные, добавлять бонусные голоса и отслеживать в журнале, кто и на какой странице проголосовал.
- Вывод на сайте: Чтобы виджеты появились в магазине, перейдите в Дизайн -> Схемы (Layouts) и добавьте созданные модули в нужные позиции на выбранных страницах.


--- [ УКРАЇНСЬКА ] ----------------------------------------------------------

ОПИС:
Poll Widget [NAT] — це функціональний модуль для створення опитувань та голосувань на вашому сайті.
1. Дозволяє створювати опитування з мультимовними питаннями та варіантами відповідей.
2. Гнучкі правила голосування: дозвіл/заборона голосування для гостей, налаштування ліміту голосів на одного користувача або IP-адресу.
3. Налаштовуваний формат результатів: виведення у відсотках, у кількості голосів, все разом або приховування результатів (тільки текст подяки).
4. Вбудований дизайн: повне керування кольорами віджета (фон, текст, кнопки, смуги прогресу) прямо з адмінки за допомогою зручного ColorPicker.
5. Просунута статистика: перегляд реальних голосів, можливість ручного коригування результатів (управління статистикою) та детальний журнал голосів із фіксацією IP, імені користувача та сторінки, з якої було віддано голос.

ВСТАНОВЛЕННЯ:
1. Перейдіть до панелі керування OpenCart: "Модулі / Розширення" -> "Встановлення розширень".
2. Завантажте архів poll_widget_nat_OC_20_22_1_0.ocmod.zip.
3. Перейдіть до "Модулі / Розширення" -> "Модифікатори" і натисніть синю кнопку "Оновити".
4. Перейдіть до "Система" -> "Користувачі" -> "Групи користувачів", виберіть вашу групу (Administrator), натисніть "Виділити все" у правах перегляду та зміни, збережіть.
5. Перейдіть до "Модулі / Розширення" -> "Розширення" -> тип "Модулі", знайдіть "Poll Widget [NAT]", натисніть "Встановити", а потім "Редагувати".

ОНОВЛЕННЯ:
1. Завантажте новий архів через "Встановлення розширень" поверх старого.
2. Оновіть кеш у розділі "Модифікатори".
3. Очистіть кеш браузера (Ctrl+F5) на сторінці налаштувань модуля.

ВИДАЛЕННЯ:
1. Перейдіть у "Модулі / Розширення", знайдіть модуль та натисніть червону кнопку "Деінсталювати".
2. Перейдіть у "Встановлення розширень", знайдіть модуль в історії та видаліть його файли.
3. Оновіть кеш модифікаторів.

ІНСТРУКЦІЯ З ВИКОРИСТАННЯ:
- Створення опитування: Додайте нове опитування, заповніть питання та відповіді для потрібних мов, налаштуйте права для гостей та ліміти.
- Зовнішній вигляд: Перейдіть у вкладку "Дизайн та кольори", щоб налаштувати палітру віджета під стиль вашого магазину.
- Статистика: У вкладці "Статистика та керування" ви можете бачити реальні дані, додавати бонусні голоси та відстежувати в журналі, хто і на якій сторінці проголосував.
- Виведення на сайті: Щоб віджети з'явилися в магазині, перейдіть до Дизайн -> Схеми (Layouts) і додайте створені модулі в потрібні позиції на обраних сторінках.


--- [ ENGLISH ] -------------------------------------------------------------

DESCRIPTION:
Poll Widget [NAT] is a powerful tool for creating responsive voting widgets and polls on your store.
1. Create unlimited polls with multi-language questions and answers.
2. Flexible voting rules: allow/disallow guest voting and set strict limits on how many times a single user or IP can vote.
3. Customizable results: display results as percentages, vote counts, both, or hide them entirely (showing only a thank-you message).
4. Built-in visual customization: adjust the widget's background, text, borders, buttons, and progress bar colors directly from the admin panel using color pickers.
5. Advanced statistics and management: view real stats, manually adjust/boost vote counts, and monitor a detailed log of voters (including Name, IP, Date, and the exact Page URL where the vote was cast).

INSTALLATION:
1. Go to OpenCart admin panel: "Extensions" -> "Installer".
2. Upload the poll_widget_nat_OC_20_22_1_0.ocmod.zip archive.
3. Go to "Extensions" -> "Modifications" and click the blue "Refresh" button.
4. Go to "System" -> "Users" -> "User Groups", edit your group (Top Administrator), click "Select All" for Access and Modify permissions, then Save.
5. Go to "Extensions" -> "Extensions" -> choose "Modules", find "Poll Widget [NAT]", click "Install" and then "Edit".

UPDATE:
1. Upload the new zip file via Extension Installer over the old one.
2. Refresh modifications cache.
3. Hard refresh your browser cache (Ctrl+F5) on the module settings page.

UNINSTALLATION:
1. Go to Extensions -> Modules, click the red "Uninstall" button next to the module.
2. Go to the Extension Installer history and delete the module files.
3. Refresh modifications cache.

INSTRUCTION:
- Poll Creation: Navigate to the module settings, click "Add New", configure the question and answers per language, and set guest/limit rules.
- Design: Use the "Design & Colors" tab to set the color scheme for your widget so it perfectly matches your theme.
- Stats Management: Go to the "Statistics & Management" tab to view real votes, add custom "bonus" votes to specific answers, and track exactly where and who is voting in the logs.
- Layouts Assignment: To display the widgets on your storefront, go to Design -> Layouts, select your desired layout (e.g., Home, Category, Information), and add the created module to your preferred position.

_________

Support: info@nat.od.ua